Resource URL: /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by/<BREAKOUT>

    Overview: Retrieve a breakout of the STAT histogram according to BREAKOUT
              parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves a histogram breakout for an individual FSA
            result set. ID in the resource path is the result set ID.

       URL: GET
            /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by/<BREAKOUT>

Query arguments:
 directory_filter=<string> Filter according to a specific directory, which
                           includes all of its subdirectories.
 attribute_filter=<string> Filter according to the name of a file user
                           attribute.
 node_pool_filter=<string> Filter according to the name of a node pool, which
                           is a set of disk pools that belong to nodes of the
                           same equivalence class.
 disk_pool_filter=<string> Filter according to the name of a disk pool, which
                           is a set of drives that represent an independent
                           failure domain.
      tier_filter=<string> Filter according to the name of a storage tier,
                           which is a user-created set of node pools.
     comp_report=<integer> Result set identifier for comparison of database
                           results.
 log_size_filter=<integer> Filter according to file logical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by logical size.
                           The list of valid log_size filter values may be
                           found by performing a histogram breakout by log_size
                           and viewing the resulting key values.
phys_size_filter=<integer> Filter according to file physical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by physical
                           size. The list of valid phys_size filter values may
                           be found by performing a histogram breakout by
                           phys_size and viewing the resulting key values.
           limit=<integer> Limit the number of breakout results.
  path_ext_filter=<string> Filter according to the name of a single file
                           extension.
    ctime_filter=<integer> Filter according to file modified time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid ctime filter values may be
                           found by performing a histogram breakout by ctime
                           and viewing the resulting key values.
    atime_filter=<integer> Filter according to file accessed time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid atime filter values may be
                           found by performing a histogram breakout by atime
                           and viewing the resulting key values.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "result_length": {
          "required": true, 
          "type": "integer", 
          "description": "Total length of the result list."
        }, 
        "breakouts": {
          "items": {
            "type": "object", 
            "properties": {
              "data": {
                "required": true, 
                "type": "array", 
                "description": "List of bucket, file count pairs.", 
                "properties": {
                  "bucket": {
                    "required": true, 
                    "type": "integer", 
                    "description": "Stat histogram bucket."
                  }, 
                  "value": {
                    "required": true, 
                    "type": "integer", 
                    "description": "Number of files in bucket."
                  }
                }
              }, 
              "key": {
                "required": true, 
                "type": "string", 
                "description": "Breakout key by which results are filtered."
              }
            }
          }, 
          "required": true, 
          "type": "array", 
          "description": "Histogram breakout data according to breakout parameter."
        }, 
        "begin_time": {
          "required": true, 
          "type": "integer", 
          "description": "Unix Epoch time of start of results collection job."
        }
      }
    }
  ]
}
